home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sources / xbmbrows / xbmbro31.z / xbmbro31 / xbmbrowser3.1 / README < prev    next >
Text File  |  1993-08-05  |  5KB  |  118 lines
  1. README file for xbmbrowser, By Ashley Roll                          Version 3.1
  2.  
  3. xbmbrowser is a program to let you easily manipulate Bitmap files.
  4.  
  5. This program has only been tested on Sun series 4 machines with X11R5.
  6.  
  7. ******************************************************************************
  8. ** xbmbrowser is Public Domain. However it, and all the code still belong to me.
  9. ** I do, however grant permission for you to freely copy and distribute it on
  10. ** the condition that this and all other copyright notices remain unchanged in
  11. ** all distributions.
  12. **
  13. ** This software comes with NO warranty whatsoever. I therefore take no
  14. ** responsibility for any damages, losses or problems that the program may
  15. ** cause.
  16. ******************************************************************************
  17.  
  18. ******************************************************************************
  19. *** THIS IS VERSION 3.0 OF XBMBROWSER  -  MOST OF THE CHANGES WERE DONE BY ***
  20.  
  21. /********************************************************************\
  22. **                             _________________________________    **
  23. **   A n t h o n y            |________    __    __    _________|   **
  24. **                                     |  |o_|  |o_|  |             **
  25. **           T h y s s e n           __|   __    __   |__           **
  26. **                                __|   __|  |  |  |__   |__        **
  27. **  `` Dragon Computing! ''    __|   __|     |  |     |__   |__     **
  28. **                            |_____|        |__|        |_____|    **
  29. **                                                                  **
  30. \********************************************************************/
  31.  
  32. ***     However I am still the person to report bug and suggestions to     ***
  33. ******************************************************************************
  34.  
  35. Xbmbrowser can now display xpm files in glorious color ;) (or even in 
  36. monocrome - but it don't quit look as good) For full details of the changes 
  37. please look at the Changes3.0 file. 
  38.  
  39. To be able to do this you will need to install the Xpm liibrary version 3.2g
  40. (the latest at the time of writing this) - it is available on 
  41. export.lcs.mit.edu and mirror its sites. If you don't want to use the Xpm stuff
  42. then you will have to comment out the 'DO_XPMS' defination line in the 
  43. Imakefile and all the XPM_LIB stuff.
  44.  
  45.  
  46. FILES:  README           - this file.
  47.         Changes3.0       - details the changes since 2.3
  48.         Imakefile
  49.         XbmBrowser-color.ad - default color setup file
  50.         Makefile.std     - the standard make file.
  51.         xbmbrowser.c     \ 
  52.         xbmbrowser.h      -
  53.         callbacks.c       - the 'C' code.
  54.         user-menu.c       -
  55.         user-menu.h       -
  56.         bitmaps.c         -
  57.         misc.c           /
  58.         icon.xbm          - icon for the program.
  59.         patchlevel.h      - the current patchlevel.
  60.         xbmbrowser.man    - a simple manual page.
  61.         xbmbrowser.help   - the help file that the program uses - see below.
  62.         xbmbrowser.menu   - The default menu setup file.
  63.  
  64. KNOWEN PATCHES:
  65.  
  66. There are no known patches 
  67.  
  68. THE COMMAND MENU.
  69. In the file xbmbrowser.menu are instructions on how to set up the menu. This 
  70. file also contains the default menu setup. You should look at it to ensure that
  71. it suits your setup. To change the location that the default file is placed you
  72. have to do the same as for the help file (see below).
  73.  
  74. HELP FILE LOCATION.
  75. You can change the deafult location at the program expects the help file to be.
  76. to do this, if you are using the Imakefile then you must change the first line
  77. in the Imakefile (the one starting with HELPFILE = -DHELPFILE=.....), this is
  78. what tells the program where to look for the file, you will then also have to 
  79. change the line "InstallNonExecFile(xbmbrowser.help,$(LIBDIR))" so that the 
  80. second parameter is where to put the file (the directory only - without the 
  81. file name).
  82. If However you are using the Makefile.std (standard makefile) you will have to
  83. change the #define HELPFILE line in xbmbrowser.h to the directory that you put
  84. the help file into. (You will have to manually move it there).
  85. If you don't wish to be able to see xpms then you will have to edit the 
  86. Imakefile or the Makefile.std and comment the DO_XPMS declaration and the -lXpm 
  87. library include.
  88.  
  89. Installation:
  90.  
  91. With Imake:
  92.  
  93.    type:
  94.      xmkmf
  95.      make
  96.      make install
  97.      make instal.man
  98.  
  99. With normal make:
  100.  
  101.    type:
  102.      mv Makefile.std Makefile
  103.      make
  104. then you will have to manually move the executable, the help file and man 
  105. page to where you want to put them.
  106.  
  107. For information on how to use xbmbrowser, look at xbmbrowser.help, or press the 
  108. [Help] button when it is running.
  109.  
  110. If you wish to change the program, then please feel free. However please
  111. leave the copyright notices unchanged but add one detailing your changes, you
  112. should also not just increment the version number, but add something unique
  113. to it (like your name or something).
  114.  
  115. If you have any problems, then please feel free to drop me a line, my E-mail
  116. address (internet) is aroll@gucis.cit.gu.edu.au
  117.  
  118.